home *** CD-ROM | disk | FTP | other *** search
/ H4CK3R 14 / hacker14.iso / programacao / visual / perl.exe / {app} / Library / Perl / todo < prev    next >
Encoding:
Text File  |  2002-11-30  |  2.3 KB  |  59 lines
  1. Perltidy TODO List
  2.     This is a "wish-list" of features to add and things to do. All of these
  3.     are of interest, but there is no particular schedule for implementing
  4.     them.
  5.  
  6.   Improved Vertical Alignment
  7.     There are many opportunities for improving vertical alignment.
  8.  
  9.   improved ?: formatting
  10.     An indentation level should be associated with ?: statements. This will
  11.     make nested ?: statements more readable.
  12.  
  13.   Fix numerous little formatting issues
  14.     There is, and always will be, a large number of other relatively minor
  15.     formatting issues that need to be addressed.
  16.  
  17.   XML Output
  18.     A -xml option would allow the creation of simple utilities to reliably
  19.     manipulate perl code.
  20.  
  21.   Documentation
  22.     A FAQ is needed to explain some of the more subtle formatting issues,
  23.     and to give examples of different styles.
  24.  
  25.     The tokenizer needs extensive documentation before it can be released as
  26.     a separate module.
  27.  
  28.   HTML writer
  29.     The HTML writer does not colorize interpolated identifiers in here
  30.     documents or quoted strings. The tokenizer outputs interpolation
  31.     information for here docs; it still needs to be updated to do this for
  32.     multi-line quotes. Then code needs to be written to scan for and markup
  33.     identifiers.
  34.  
  35.   Tokenization issues
  36.     There are some subtle issues with distinguishing block types that should
  37.     be addressed to make the tokenizer more correct, even though they do not
  38.     interfere with code beautification. For example, in most cases the type
  39.     of a brace is known when it is encountered. But given this coding
  40.  
  41.      sub something {
  42.          {
  43.             bla, bla
  44.          }
  45.          ..
  46.      }
  47.  
  48.     we have to examine the first couple of tokens of the interior braces to
  49.     see if it is a code block or anonymous hash reference. This needs to be
  50.     done. Also, brace types of something like ${ ... } are not currently
  51.     labeled as code blocks because this simplifies formatting. However, this
  52.     should be done eventually for correctness.
  53.  
  54.     Token type 'M' (for Method) has been reserved for subroutine definition
  55.     names. It needs to be implemented; I've patched around this in the html
  56.     writer for now. I'm considering new token types for prototypes and
  57.     attributes, to simplify parsing and formatting.
  58.  
  59.